❯ npx bmad-method install
██████╗ ███╗ ███╗ █████╗ ██████╗ ███╗ ███╗███████╗████████╗██╗ ██╗ ██████╗ ██████╗
██╔══██╗████╗ ████║██╔══██╗██╔══██╗ ████╗ ████║██╔════╝╚══██╔══╝██║ ██║██╔═══██╗██╔══██╗
██████╔╝██╔████╔██║███████║██║ ██║█████╗██╔████╔██║█████╗ ██║ ███████║██║ ██║██║ ██║
██╔══██╗██║╚██╔╝██║██╔══██║██║ ██║╚════╝██║╚██╔╝██║██╔══╝ ██║ ██╔══██║██║ ██║██║ ██║
██████╔╝██║ ╚═╝ ██║██║ ██║██████╔╝ ██║ ╚═╝ ██║███████╗ ██║ ██║ ██║╚██████╔╝██████╔╝
╚═════╝ ╚═╝ ╚═╝╚═╝ ╚═╝╚═════╝ ╚═╝ ╚═╝╚══════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝
🚀 Universal AI Agent Framework for Any Domain
? Enter the full path to your project directory where BMad should be installed:
? Select what to install/update (use space to select, enter to continue): BMad Agile Core System (v4.43.1) .bmad-core
📋 Document Organization Settings
Configure how your project documentation should be organized.
? Will the PRD (Product Requirements Document) be sharded into multiple files? Yes
? Will the architecture documentation be sharded into multiple files? Yes
⚠️ IMPORTANT: This is a MULTISELECT! Use SPACEBAR to toggle each IDE!
🔸 Use arrow keys to navigate
🔸 Use SPACEBAR to select/deselect IDEs
🔸 Press ENTER when finished selecting
? Which IDE(s) do you want to configure? (Select with SPACEBAR, confirm with ENTER): Cursor, Claude Code, iFlow CLI, Windsurf, Trae, Roo Code, Kilo
Code, Cline, Gemini CLI, Qwen Code, Crush, Github Copilot, Auggie CLI (Augment Code), Codex CLI, Codex Web
🔧 GitHub Copilot Configuration
BMad works best with specific VS Code settings for optimal agent experience.
? How would you like to configure GitHub Copilot settings? Use recommended defaults (fastest setup)
📍 Auggie CLI Location Configuration
Choose where to install BMad agents for Auggie CLI access.
? Select Auggie CLI command locations: Workspace Commands (Project): Stored in repository, shared with team
? Would you like to include pre-built web bundles? (standalone files for ChatGPT, Claude, Gemini) Yes
📦 Web bundles are standalone files perfect for web AI platforms.
You can choose different teams/agents than your IDE installation.
? What web bundles would you like to include? All available bundles (agents, teams, expansion packs)
? Enter directory for web bundles: web-bundles
⠋ Analyzing installation directory... Processed 67 files with {root} replacement
Added 3 documentation files
✓ Installed all web bundles to: web-bundles
✓ Created rule: ux-expert.mdc
✓ Created rule: bmad-orchestrator.mdc
⠙ Setting up cursor integration...✓ Created rule: bmad-master.mdc
✓ Created rule: architect.mdc
✓ Created rule: analyst.mdc
✓ Created Cursor rules in .cursor/rules/bmad
✓ Created agent command: /ux-expert
✓ Created agent command: /sm
✓ Created agent command: /qa
✓ Created agent command: /po
✓ Created agent command: /pm
✓ Created agent command: /dev
✓ Created agent command: /bmad-orchestrator
✓ Created agent command: /bmad-master
✓ Created agent command: /architect
✓ Created agent command: /analyst
✓ Created task command: /validate-next-story
✓ Created task command: /trace-requirements
✓ Created task command: /test-design
✓ Created task command: /shard-doc
✓ Created task command: /risk-profile
✓ Created task command: /review-story
✓ Created task command: /qa-gate
✓ Created task command: /nfr-assess
✓ Created task command: /kb-mode-interaction
✓ Created task command: /index-docs
✓ Created task command: /generate-ai-frontend-prompt
✓ Created task command: /facilitate-brainstorming-session
✓ Created task command: /execute-checklist
✓ Created task command: /document-project
✓ Created task command: /create-next-story
✓ Created task command: /create-doc
✓ Created task command: /create-deep-research-prompt
✓ Created task command: /create-brownfield-story
✓ Created task command: /correct-course
✓ Created task command: /brownfield-create-story
✓ Created task command: /brownfield-create-epic
✓ Created task command: /apply-qa-fixes
✓ Created task command: /advanced-elicitation
✓ Created Claude Code commands for core in .claude/commands/BMad
- Agents in: .claude/commands/BMad/agents
- Tasks in: .claude/commands/BMad/tasks
✓ Created agent command: /ux-expert
✓ Created agent command: /sm
✓ Created agent command: /qa
✓ Created agent command: /po
✓ Created agent command: /pm
✓ Created agent command: /dev
✓ Created agent command: /bmad-orchestrator
✓ Created agent command: /bmad-master
✓ Created agent command: /architect
✓ Created agent command: /analyst
✓ Created task command: /validate-next-story
✓ Created task command: /trace-requirements
✓ Created task command: /test-design
✓ Created task command: /shard-doc
✓ Created task command: /risk-profile
✓ Created task command: /review-story
✓ Created task command: /qa-gate
✓ Created task command: /nfr-assess
✓ Created task command: /kb-mode-interaction
✓ Created task command: /index-docs
✓ Created task command: /generate-ai-frontend-prompt
✓ Created task command: /facilitate-brainstorming-session
✓ Created task command: /execute-checklist
✓ Created task command: /document-project
✓ Created task command: /create-next-story
✓ Created task command: /create-doc
✓ Created task command: /create-deep-research-prompt
✓ Created task command: /create-brownfield-story
✓ Created task command: /correct-course
✓ Created task command: /brownfield-create-story
✓ Created task command: /brownfield-create-epic
✓ Created task command: /apply-qa-fixes
✓ Created task command: /advanced-elicitation
✓ Created iFlow CLI commands for core in .iflow/commands/BMad
- Agents in: .iflow/commands/BMad/agents
- Tasks in: .iflow/commands/BMad/tasks
✓ Created workflow: ux-expert.md
✓ Created workflow: sm.md
✓ Created workflow: qa.md
✓ Created workflow: po.md
✓ Created workflow: pm.md
✓ Created workflow: dev.md
✓ Created workflow: bmad-orchestrator.md
✓ Created workflow: bmad-master.md
✓ Created workflow: architect.md
✓ Created workflow: analyst.md
✓ Created Windsurf workflows in .windsurf/workflows
✓ Created rule: ux-expert.md
⠹ Setting up trae integration...✓ Created rule: qa.md
✓ Created rule: bmad-orchestrator.md
✓ Created rule: bmad-master.md
✓ Created rule: architect.md
✓ Created rule: analyst.md
✓ Added mode: bmad-ux-expert (🎨 UX Expert)
✓ Added mode: bmad-sm (🏃 Scrum Master)
✓ Added mode: bmad-qa (🧪 Test Architect & Quality Advisor)
✓ Added mode: bmad-po (📝 Product Owner)
✓ Added mode: bmad-pm (📋 Product Manager)
✓ Added mode: bmad-dev (💻 Full Stack Developer)
✓ Added mode: bmad-bmad-orchestrator (🎭 BMad Master Orchestrator)
✓ Added mode: bmad-bmad-master (🧙 BMad Master Task Executor)
✓ Added mode: bmad-architect (🏗️ Architect)
✓ Added mode: bmad-analyst (📊 Business Analyst)
✓ Created .roomodes file in project root
✓ Roo Code setup complete!
Custom modes will be available when you open this project in Roo Code
✓ Added Kilo mode: bmad-ux-expert (🎨 UX Expert)
✓ Added Kilo mode: bmad-sm (🏃 Scrum Master)
✓ Added Kilo mode: bmad-qa (🧪 Test Architect & Quality Advisor)
✓ Added Kilo mode: bmad-po (📝 Product Owner)
✓ Added Kilo mode: bmad-pm (📋 Product Manager)
✓ Added Kilo mode: bmad-dev (💻 Full Stack Developer)
✓ Added Kilo mode: bmad-orchestrator (🎭 BMad Master Orchestrator)
✓ Added Kilo mode: bmad-master (🧙 BMad Master Task Executor)
✓ Added Kilo mode: bmad-architect (🏗️ Architect)
✓ Added Kilo mode: bmad-analyst (📊 Business Analyst)
✓ Created .kilocodemodes file in project root
✓ KiloCode setup complete!
Custom modes will be available when you open this project in KiloCode
✓ Created rule: 10-ux-expert.md
✓ Created rule: 08-dev.md
✓ Created rule: 02-bmad-orchestrator.md
✓ Created rule: 01-bmad-master.md
✓ Created rule: 05-architect.md
✓ Created rule: 04-analyst.md
✓ Created Cline rules in .clinerules
✓ Created agent command: /bmad:agents:ux-expert
✓ Created agent command: /bmad:agents:sm
✓ Created agent command: /bmad:agents:qa
✓ Created agent command: /bmad:agents:po
✓ Created agent command: /bmad:agents:pm
✓ Created agent command: /bmad:agents:dev
✓ Created agent command: /bmad:agents:bmad-orchestrator
✓ Created agent command: /bmad:agents:bmad-master
✓ Created agent command: /bmad:agents:architect
✓ Created agent command: /bmad:agents:analyst
✓ Created task command: /bmad:tasks:validate-next-story
✓ Created task command: /bmad:tasks:trace-requirements
✓ Created task command: /bmad:tasks:test-design
✓ Created task command: /bmad:tasks:shard-doc
✓ Created task command: /bmad:tasks:risk-profile
✓ Created task command: /bmad:tasks:review-story
✓ Created task command: /bmad:tasks:qa-gate
✓ Created task command: /bmad:tasks:nfr-assess
✓ Created task command: /bmad:tasks:kb-mode-interaction
✓ Created task command: /bmad:tasks:index-docs
✓ Created task command: /bmad:tasks:generate-ai-frontend-prompt
✓ Created task command: /bmad:tasks:facilitate-brainstorming-session
✓ Created task command: /bmad:tasks:execute-checklist
✓ Created task command: /bmad:tasks:document-project
✓ Created task command: /bmad:tasks:create-next-story
✓ Created task command: /bmad:tasks:create-doc
✓ Created task command: /bmad:tasks:create-deep-research-prompt
✓ Created task command: /bmad:tasks:create-brownfield-story
✓ Created task command: /bmad:tasks:correct-course
✓ Created task command: /bmad:tasks:brownfield-create-story
✓ Created task command: /bmad:tasks:brownfield-create-epic
⠸ Setting up gemini integration...✓ Created task command: /bmad:tasks:apply-qa-fixes
✓ Created task command: /bmad:tasks:advanced-elicitation
✓ Created Gemini CLI extension in .gemini/commands/BMad/
You can now use commands like /bmad:agents:dev or /bmad:tasks:create-doc.
✓ Added context for *ux-expert
✓ Added context for *bmad-orchestrator
✓ Added context for *bmad-master
✓ Added context for *architect
✓ Added context for *analyst
✓ Created QWEN.md in .qwen/bmad-method
✓ Created agent command: /ux-expert
✓ Created agent command: /sm
✓ Created agent command: /qa
✓ Created agent command: /po
✓ Created agent command: /pm
✓ Created agent command: /dev
✓ Created agent command: /bmad-orchestrator
✓ Created agent command: /bmad-master
✓ Created agent command: /architect
✓ Created agent command: /analyst
✓ Created task command: /validate-next-story
✓ Created task command: /trace-requirements
✓ Created task command: /test-design
✓ Created task command: /shard-doc
✓ Created task command: /risk-profile
✓ Created task command: /review-story
✓ Created task command: /qa-gate
✓ Created task command: /nfr-assess
✓ Created task command: /kb-mode-interaction
✓ Created task command: /index-docs
✓ Created task command: /generate-ai-frontend-prompt
✓ Created task command: /facilitate-brainstorming-session
✓ Created task command: /execute-checklist
✓ Created task command: /document-project
✓ Created task command: /create-next-story
✓ Created task command: /create-doc
✓ Created task command: /create-deep-research-prompt
✓ Created task command: /create-brownfield-story
✓ Created task command: /correct-course
✓ Created task command: /brownfield-create-story
✓ Created task command: /brownfield-create-epic
✓ Created task command: /apply-qa-fixes
✓ Created task command: /advanced-elicitation
✓ Created Crush commands for core in .crush/commands/BMad
- Agents in: .crush/commands/BMad/agents
- Tasks in: .crush/commands/BMad/tasks
Using pre-configured GitHub Copilot settings: defaults
✓ Using recommended BMad defaults for Github Copilot settings
✓ VS Code workspace settings configured successfully
Settings written to .vscode/settings.json:
• chat.agent.enabled: true
• chat.agent.maxRequests: 15
• github.copilot.chat.agent.runTasks: true
• chat.mcp.discovery.enabled: true
• github.copilot.chat.agent.autoFix: true
• chat.tools.autoApprove: false
You can modify these settings anytime in .vscode/settings.json
✓ Created chat mode: ux-expert.chatmode.md
✓ Created chat mode: sm.chatmode.md
✓ Created chat mode: qa.chatmode.md
✓ Created chat mode: po.chatmode.md
✓ Created chat mode: pm.chatmode.md
✓ Created chat mode: dev.chatmode.md
✓ Created chat mode: bmad-orchestrator.chatmode.md
✓ Created chat mode: bmad-master.chatmode.md
✓ Created chat mode: architect.chatmode.md
✓ Created chat mode: analyst.chatmode.md
✓ Github Copilot setup complete!
You can now find the BMad agents in the Chat view's mode selector.
Using pre-configured Auggie CLI (Augment Code) locations: workspace
✓ Created command: ux-expert.md in Workspace Commands (Project)
✓ Created command: sm.md in Workspace Commands (Project)
✓ Created command: qa.md in Workspace Commands (Project)
✓ Created command: po.md in Workspace Commands (Project)
✓ Created command: pm.md in Workspace Commands (Project)
✓ Created command: dev.md in Workspace Commands (Project)
✓ Created command: bmad-orchestrator.md in Workspace Commands (Project)
✓ Created command: bmad-master.md in Workspace Commands (Project)
✓ Created command: architect.md in Workspace Commands (Project)
✓ Created command: analyst.md in Workspace Commands (Project)
✓ Created Auggie CLI commands in .augment/commands/bmad/
Location: Workspace Commands (Project) - Stored in your repository and shared with your team
⠼ Setting up codex integration...✓ Created/updated AGENTS.md for Codex CLI integration
Codex reads AGENTS.md automatically. Run `codex` in this project to use BMAD agents.
✓ Added npm scripts: bmad:refresh, bmad:list, bmad:validate
✓ Added .bmad-core/* to .gitignore for local-only Codex setup
✓ Created/updated AGENTS.md for Codex CLI integration
Codex reads AGENTS.md automatically. Run `codex` in this project to use BMAD agents.
✓ Updated .gitignore to include .bmad-core in commits
✓ BMad Method installed successfully!
✓ .bmad-core framework installed with all agents and workflows
✓ Web bundles (all bundles) installed to: web-bundles
✓ IDE rules and configurations set up for: cursor, claude-code, iflow-cli, windsurf, trae, roo, kilo, cline, gemini, qwen-code, crush, github-copilot, auggie-cli, codex, codex-web
📖 IMPORTANT: Please read the user guide at docs/user-guide.md (also installed at .bmad-core/user-guide.md)
This guide contains essential information about the BMad workflow and how to use the agents effectively.